QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Error-Reporting For Extensions

Extensions may need to report errors, warnings, and notices. These reports are handled by application-supplied handlers, or by the default QuickDraw 3D handlers if the application doesn't provide alternatives.

Q3XError_Post

You can use the Q3XError_Post function to post a QuickDraw 3D error from an extension.

void Q3XError_Post (TQ3Error error);
error
A code that indicates the type of error that has occurred.

DESCRIPTION

The Q3XError_Post function posts the error code passed in the error parameter.

Q3XWarning_Post

You can use the Q3XWarning_Post function to post a QuickDraw 3D warning from an extension.

void Q3XWarning_Post (TQ3Warning warning);
warning
A code that indicates the type of warning.

DESCRIPTION

The Q3XWarning_Post function posts the warning code passed in the warning parameter.. The warning code you pass into this routine must already be defined in QD3DErrors.h .

Q3XNotice_Post

You can use the Q3XNotice_Post function to post a QuickDraw 3D notice from an extension.

void Q3XNotice_Post (TQ3Notice notice);
notice
A code that indicates the type of notice.

DESCRIPTION

The Q3XNotice_Post function posts the notice code passed in the notice parameter.. The notice code you pass into this routine must already be defined in QD3DErrors.h .

Q3XMacintoshError_Post

You can use the Q3XMacintoshError_Post function to post the QuickDraw 3D error kQ3ErrorMacintoshError or the Mac OS error macOSErr .

void Q3XMacintoshError_Post (OSErr macOSErr);
macOSErr
A Mac OS or QuickDraw 3D error code.

DESCRIPTION

The Q3XMacintoshError_Post function posts the error code passed in the macOSErr parameter. You can retrieve this code by using Q3MacintoshError_Get , described on [link] .


© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |